HarmonyOS NEXT 诊断日志拉取

mPaaS 的客户端 SDK 为用户提供写入诊断日志的接口。该诊断日志是指您根据开发需求或排查问题的需要，调用诊断日志接口写入的日志。此类日志默认只会记录在磁盘中，并不上传。

需要排查问题时，您可以通过日志提取功能下发诊断任务到客户端，客户端收到任务后上传日志到服务器，您便可以在应用分析控制台上下载上传的日志。

前置条件

• 拉取实时日志前，确保已完成客户端诊断日志埋点。有关日志埋点操作，请参见移动分析 HarmonyOS NEXT 客户端诊断。

• 如果通过 Push 通道拉取诊断日志，那么需要先接入 Push 组件，并且配置上透传消息 Ability，保证透传消息可正常接收 。 详情请参考 配置透传消息 Ability。

• 如果通过 Sync 通道拉取诊断日志，那么需要先接入 Sync 组件，并保证 Sync 消息可正常接收。

日志拉取

下载服务端日志的操作如下：

1. 登录 mPaaS 控制台，从左侧导航栏进入 移动分析 > 日志管理 > 拉取实时日志 页面。

2. 单击 添加 按钮进入 新增诊断任务 页面，然后根据页面提示填写诊断任务内容。

3. 填写完诊断任务信息后，单击 确定 按钮，生成一条诊断任务。

4. 在诊断任务列表中，选择刚创建的任务，并选择 触发通道，然后单击 触发 按钮以触发诊断任务的下发。任务下发成功后，页面上的任务状态会更新。

   触发通道需要与客户端接入诊断的方式保持一致，即如果诊断方式为 消息推送，则触发通道必须选择 通过消息推送（Push）。

   

5. 客户端收到诊断任务后，将日志上传到服务器，同时任务状态更新为 处理完成。此时，您可以单击 查看 按钮进入子任务查看页面，单击 下载 按钮下载日志。